Lecture #2 


(aka the Fart Lecture) THE GAS WE PASS 
e Story of Farts 
By Shint 


- Part 1: Basic C++ Concepts 
- Constructors 
- Destructors 
- Class Composition 
- Composition with Initializer Lists 
* Part 2: On-your-own Study Topics 
Learning how to use the Visual C++/Xcode debuggers 
A few final topics you need to know to do Project #1 


NOTE: I will be teaching class on Friday during your normal 
discussion sections. Please plan to attend (it won't be a regular 
discussion section - it'll be CLASS)! 


Classrooms for each section will be posted on the class website! 


Meme, anyone? 
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Constructors 


Destructors 


Constructors and Destructors 
What's the big picture? 


A constructor function is used to reset an 
object's member variables when the object is 
first created; otherwise they'd be random! 


class SomeClass { 
public: 

void blah() ( cout << v; } // random value! 
private: 

int v; // uninitialized if no constructor! 


ji 


An object will often reserve memory slots from 
the operating system while it runs. 


A destructor function guarantees that reserved 
memory is freed when an object goes away. 


If you don't free this memory, your program will 
eventually run out of memory and crash. 


€ 
Constructor Basics - 


class Gassy Here's our Gassy class... 


{ It represents gassy people. 

p Our G | h tructor that 

: . ur Gassy class has a constructor tha 

Cassy Caras; n Bn atic takes He geen to initialize it. 

{ * Ifa constructor has parameters, then 
m age = age; you must pass values in to them that 
m ateBeans = ateBeans; match the types of the parameters! 

* Notice down below, that when we 

} construct betty we pass in two values, 
so it works just fine 

* But when we construct alan, we don't 

{ pass any parameters in, so this would 
if(m ateBeans == true) fail. 


return (100) ; 
return(3 * m age); 


int getFartsPerHr() 


int main( 


í 


private: 
int m age; 
bool m ateBeans; Gassy alan; // error! 


Gassy betty(18,true); 


a 


class Gassy 


{ 
public: 
Gassy (int age, bool ateBeans) 
{ 
m age = age; 
m ateBeans = ateBeans; 
} 
Gassy () 
{ 
m age = 0; 
m ateBeans = false; 


) 


int getFartsPerHr () 

{ 
if (m_ateBeans == true) 

return (100) ; 

return(3 * m age); 

} 

private: 
int m_age; 
bool m_ateBeans; 


J? 


Constructor Basics 


* Your class can have many different 
constructors... 

* The only requirement is that each one 
has different parameters and/or types. 

* This is called constructor overloading. 

e So now, our definition below of the alan 
variable will work, and will result ina 
call to the second constructor. 

e Notice that we don't need (and in fact, 
we are not allowed to have) 
parentheses after the definition of the 
alan variable. 


int main () 
{ 
Gassy betty (18,true) ; 


Gassy alan; // OK!!! 


Constructor Basics 


class Gassy * If you don't define any constructors 
{ at all then C++ generates an implicit, 
, default constructor for you. 

public: * But this default constructor won't 

initialize your object's primitive 

member variables! 

{ e Primitive variables include native C++ 
// I don’t init primitive member types like int, float, double, bool, etc. 


// variables. So be careful!!! *  Non-primitives include string, Gassy, 


Gassy() // generated by compiler 


etc. 
! e So the call to getFartsPerHr() below 
int getFartsPerHr() will result in random values being 
( printed. 


if(m ateBeans -- true) 
return(100); 
return(3 * m age); 


) 


int main() 


{ 


private: 
int m age; These variables will have Gassy carey; 
bool m ateBeans? random values! 


ee 


cout << 


carey.getFartsPerHr(); //?? 


When Constructors are 
Called 


A constructor is called 
any time you create a new 
variable of a class. 


int main() 


A constructor is called N 
times (once for each array 
element) when you create 
an array of size N. 


Gassy carey(45 false), bill: 


Gassy arr[b2] 


A constructor is called 
when you use new to 
dynamically allocate a new 
variable. 


Gassy *ptr = new Gassy(1,false); 


for (int i=O; i < 10; ++i) { 
Gassy temp; 


If a variable is declared 
in a loop, it is newly 
constructed during 

EVERY iteration! 


Gassy *justAPtr: The constructor is not called when 
) you just define a pointer variable! 


And now it's time for... 


Figure out what 
the obfuscated 
C program does! 


#include /*!!TAS-4!*/«stdio.h» 

#include /*((IOCCC2))*/«SDL.h» 

#define b/*((IOCCC257))*/ if ( 
define a(b, c) for (b = 0 ; /*IOCCC/2014*/b«d; b**,c) 
e,h,f,g,i,j],k,l,m,n,o,p*1,*q,r,s8-5, t,*u,xX,y,2,A,B, Cl 


333*7],d-333; D,E,F,G [2 ],H, 


I, Jd, K, 


L, M,N- 1,0,P,0 


.*R;char * S, **T; /*33*/ i 
SDL Surface*U,* V; int*W( x 
is mr *7; b*u)( ita Ra *u[0]; y-u[1 
; Heu 32 - 
i; A-( n/8)*i ; B-u[ 
)/**/; return ur 7} 
0; } Y ()( 0-50; r= 0; t-1 
) 2 (X m, h,0)/**/ {q fea/ 
return W(X)&&B&&(m« x*i&k&n 
y*i&&xcm*ik& y*n*o); ) int*ba(int*u)( int X 


,*bb-C; a(x, 
"bb +1; H*6; 


Oo-i*2; 


N 

E 

S 
*/return bb; 


) } return 0; 


(be,bf)( int X,bg; mt=be; nt=bf; I-e 
-i; mem«0?0:(m»I?I:m); a(X,0)( b 2(X 
7™,N,0)){ bg-B&1; b D&&bg) continue; 
m--be; n-*bf; b B&B)( u[-1]-0; j=l; bc(8); b 8532)( n-= i; 


) be(e){ a[2]7e; 


bbt=7){ b!*bb)( *bb-1; R 
while(H--)*Ret=*ute; /*W 


) bà 


) ) b B&16&&10)( bc(32*(0»128:0)); Y(); u[- 1]-0; } 


b(B&128&&bf&&8«0)||(B&641))u[-1]*0; b bg&&41!0)( b bf&&s »0)( 


u[2]--; 


) eise ( bc(24); Y(); L--1; 


u[3]*bf-0; s--6; ) else ( b j)( bc(0); b o»i) nt-o-i; D-30; j-0; 
} } } b B44){ b bf&&scO)( int I[]={ x,y-i,u[ 


5],u[4],rànd()*221:-1,2) ; u[2]**; u[3]-2; ba(I); ) ) b bf)s-1; break; ) 


eres !- 


) bh (m,e,k, bi)( H=k/ 2; G[bi]*m»e-H? x 
e: (m>H?H-m:0 ); ) bj(X,be ,bf)( int bk 3 
[O]*t=be; u[1 ]t-bf; W(X); E=x,F«y,I=0; a 
bk,0){ b I-(XI -bX&&Z(bk,E,F,i)&&(B&6 
)break; ) W(X); b I)( b bf)u[l]--bf; 

)( w[0]--be; u[4]*--1*be; ) } W( X); ) 
(){ int bm-n,X; SDL FillRect(U,0,M); X=4; while; x 
Jbd(r,0); X-3; while(X--)bd(0,8]); b n»h&&!O)Y () ; 
“bm=<n; q[0]*m; q[1]*n; bh(m,e,k,0); bh(n,h,1,1) : 


&(X,0)( b W(X))( b B&9]( b2(X,u[4],0); bj(X,0,2); ) b B&1){ *u *-u[4]; b 


**u[5]220)( u[4]*- 
932?1:0; ) J=i; ba 
r)zt-1*(K$2); bit) 
; }} b atau] [1 (D&& 


bn*( 2,A,i,J) ,bo- 
J}; SDL BlitSurface 
} b(st-2)22)s8-2; K 
b!-- 0) exit(L); } 
(T(X],0,0); ) baint H , 
bt-Q-P; b bt>bs) bt- bs; 
128); Pt-bt; b P»-Q)P-0; 
,8,1,0,256,0,0,bed) ,bv ; 


"bx; int by,H-255, 
bC-bp(5),bD-bp(6); 
,i=bp(2),ebp(3),h 
Oxffff 
b3-255 
SANDRO 
,bA,bB); fread(V-» 
bu,0); SDL LoadWAV 
for(; ; )( int u[6 


SDL PollEvent(&bE) 
type--2))( I = bE. 
by?0:(p=-1}; b I-- 


-1; u[(5]*0; ) z*-K 

*-u)( Jo; b!O)( b 

2-248; z*-p«02i*4:0 

0--D$3))( SDL Rect 
{ G[0]*x,G[1]*y,i, 
(V,&bn,U,&bo); ) } 
++; D-*D?1:0; b O) 
bp(X)( return strtol 
int*br,int bs )( int bt; 
SDL MixAudio(br,S *P,bt, 
) SDL AudioSpec bu-(8000 
main(int bw,char**bx)( T 


bz-H««B ,bÀ -bz <<B,bB= bA««8, 
SDL Event bE; o sis bc / B; k = bp(1) 
-bp (4); M= bp(9); /**/  SDL Init(/*«2053"*/ 
); bi*(char*) &N)( H-bB; bz *bÀ; bA -bz»-B; 
; ) U*SDL_SetVideoMode(x,1,0,0); V=/*NES HISTORY 
*/ SDL_CreateRGBSurface(1 ««15 , bC, bD, 32,H,bz 
pixels,bC*bD*4,1,fopen(T [7], "r" )); SDL_OpenAudio(& 
(T[8],& bv,&S,&Q ); /**/ “SDL PauseAudio(0); 
],*I; H -0 ; whil (H < 6) scanf(/*0*/ 
**d ", utltt*); b u[5]< 0)break 
u);blu I3)t(«a "Itl; m *u[0 J; 
}} for (33 MH while/*  !MAFFIO 
) { by- bE.type ==3; b!O &&(by|| bE. 
key/**/ .Xeysym -sym; b I-- 276)r= 
275 )r- by?0:(p <1); b I--32)by? 


0:(t?(s--9):0); b I--27)exit(0); ) ) bi(); SDL Flip(U); SDL Delay(60); ) } 


g~ 


; I=ba( 
n-u[1]; 
DO.S*/( 


Destructors 


class Gassy 


{ 
public: 


~Gassy () 
{ 


// your destructor 
// code goes here 


} 


private: 


ee 


Just as every class has a constructor, 
every class also has a destructor 
function (it may have only one of 
these). 

The job of the destructor is to de- 
initialize or destruct a class variable 
when it goes away. 

Destructors must NOT have any 
parameters. 

To define a destructor function, place 
a tilde ~ character in front of the 
name of the class. 

It looks just like a constructor 
function except for the tilde ~ which 
identifies it as a destructor. 
Destructors must NOT return a value 
either. They *can* use the return; 
command, they just can't return a 
value, e.g. return 7; 


Destructors 


class Gassy 
{ 
public: 


Gassy () 
{ 

m age = 0; 

m ateBeans = false; 
) 


int getNerdScore () 
{ 
if (m_ateBeans == true) 


return (100) ; 
return(3 * m age); 
} 
~Gassy() // generated by compiler 
{ 
} 


private: 
int m_age; 
bool m ateBeans; 


|a 


If you don't define your own 
destructor for a class... 

Then C++ will define an 
implicit one for you... 

This ensures that objects of 
your class properly go away 
when they go out of scope. 
We'll see exactly why in a bit. 


Why Do We Need Destructors? 


class SpotifyPlayer 
{ 


public: 
SpotifyPlayer() 
{ 


// Reserve 100MB of disk space to temporarily 
// cache downloaded MP3 music files. 
reserveSpaceOnDisk(100000000); 


void playSong(string songURL) 
{ 


// First download song to reserved space on disk. 
downloadMP3 ToReservedSpace(songURL); 

// Then play the song that was saved to our disk. 
playMP3InReservedSpace(); 


int main() 


{ 

// Obsessively play k-pop music! 
for (int i = O; i < 100; ++i) 
{ 


* Can anyone see what the problem is? 
* Every time we construct a new 


SpotifyPlayer variable, it reserves 
100MB on disk. 


* But our SpotifyPlayer class never 


deletes the reserved spacel 


* Now,as it turns out, if you define a 


class variable inside a loop, C** will 
create a new variable from scratch 
EVERY TIME THE LOOP RUNS! 


* Soevery time the loop runs, it 


creates a whole new SpotifyPlayer 
variable and reserves 100MB 


* If the loop runs 10 times, you'll end 


up reserving 1GB of space! 


* Eventually your hard drive will run 


out of disk space. 


SpotifyPlayer a; // € a's c'tor runs every loop iteration! 
a.playSong(" http://spotify.com/dad.mp3^"); 


Why Do We Need Destructors? 


Once we add the destructor to 
" SSpotifyPlayer we've fixed the problem! 

* Why? If you define a class variable inside 
a loop (like variable a below), C++ will run 
the variable's destructor EVERY TIME 
THE LOOP reaches the closing bracer of 
the loop! 

* Soevery time the loop runs, it creates a 
whole new SpotifyPlayer variable and 
reserves 100MB 

* And every time the loop runs, when it hits 
the closing bracer ) of the loop, C++ runs 
the destructor of the variable. 

* If the loop runs 10 times, C++ will reserve 
100MB of space where the variable is 
defined, and it will free the reserved 
100MB where each time it reaches the ) in 
the loop. 

* So +100MB in, -100MB out, and by the end 

of each loop iteration, you have O disk 

Space reserved. 


class SpotifyPlayer 
( 


public: 
SpotifyPlayer() 
( 


// Reserve 100MB of disk space to 
temporarily 
// cache downloaded MP3 music files. 
reserveSpaceOnDisk(100000000); 


~SpotifyPlayer() 
{ 
// Free the reserved space on disk. 


freeReservedSpace(); 
} 


void playSong(string songURI jnt main() 
{ 


// First download song 1  // Obsessively play k-pop music! 
downloadMP3ToReserved| for (int i = O; i < 100; ++i) 
// Then play the song t! ( 
playMP3InReservedSpace ^ SpotifyPlayer a; // € a's c'tor runs every iteration 
a.playSong( http://spotify.com/dad.mp3"); 
) // € a's destructor runs every loop iteration! 


} 


When must you have a destructor? 


Any time a class allocates Your class must have a 
a system resource... destructor that... 
Reserves memory using Frees the allocated memory 

the new command with the delete command 
Opens a disk file Closes the disk file 

Connects to another computer Disconnects from the 

over the network other computer 


Don't forget or you'll FAIL! 


Destructors 


So when is a destructor called anyway? 


e Local objects defined in a function are destructed when they 
void Dingleberry() "go out of Scope." 
e Variables defined in a function (like variable a) go out of scope 
SomeClass a: when the function exits. 


e Variables defined in a { block } are destructed when the block 
finishes. A block is one or more lines of code surrounded by { }. 
So variable b will be constructed once every time the loop runs, 
for (int j=0: j<10; j++) and destructed once every time the loop runs (when the loop 
reaches the }). 
e Dynamically allocated variables (e.g., allocated using the new 
SomeClass b; command) have their destructor run ONLY when delete is 
// do something called, before the memory is actually freed by the OS. 


) — b's destructor is called each time we hit the end of the block 


MP3Player *m = new MP3Player: 
m-»getSong( www.music.com/x.wav"); 
m->playSong(); 

delete m; «—— m's destructor is called here 


(if you don't use delete, m's d'tor is never 
called - not even when the program ends!) 


) —— a's destructor is called here 


Destructors 


So when is a destructor called anyway? 


void Dingleberry() 


Finally, when you define an array of 
N items, the destructor is called 
N times when the array goes away... 


SomecClass a; 
SomeClass x[42]; 


for (int j=0; j<10; j++) 
{ 


SomeClass b; 
// do something 
} 


MP3Player *m = new MP3Player: 
m-»getSong( www.music.com/x.wav"); 
m->playSong(); 

delete m; 


} 
is The destructor is called 42 times for x here! 


e 


w^ 2 
PY04 vo wc 


“anguage inventor 


> Sevial killey 


See if you can guess who uses a keyboard and 
who uses a chainsaw! 


Class Composition 
What's the big picture? 


Class composition is when a class 
contains one or more member variables 
that are also classes. 


class Player ( The important thing to 
= watch out for in the next 

» set of slides is the 

class Enemy ( process/syntax C++ uses 
$ to initialize these 

J member variables. 

class VideoGame { 


private: 
Player user_hero; Class 
Enemy enemies[10]; Composition 


class Stomach { Class Composition 


public: 


Stomach() { myGas = O; } So how does construction work 
void eat() { myGas ++; } when we use class composition? 
jp" Let's look at three classes... 


l C++ always constructs member variables 
class Brain { first, in the order they're defined in the 
public: class (so myBelly would be constructed first, 
; = ; then myBrain would be constructed second). 
Brain(). ( myIQ = 100; } Finally, C++ runs the constructor of the 
void think() ( myIQ += 10; } outer variable (the nerd) last after its 
e member variables have been 
initialized/constructed. 
This makes sense. Since our outer class 
constructor (HungryNerd) uses its member 
variables (myBelly.eat()), those member 
variables must have already been 
constructed or they couldn't be used! 


E 

class HungryNerd ( 

public: 
HungryNerd() 
( 


myBelly.eat(); 
myBrain.think(); 


private: 


Stomach myBelly; 


Brain myBrain; 
F 


class Stomach { 


How does this actually work? 


public: * When an outer object like HungryNerd contains 
- N member objects (like myBelly and myBrain), C++ 
Stomach() { myGas 0; } secretly ate code to the a top of the outer 
void eat() { myGas Te } class's constructor to FIRST call the default 
constructors of all the member objects: 
y e This code is added by the compiler to your 


final program (you won't see it in your code) 


. * A default constructor is one that doesn't require 
class Brain ( any parameters (like Stomach's or Brain's). 
public: * AFTER C++ finishes constructing the member 

. = , variables, C++ then runs the body of the outer 
Brain() ( myIQ = 100; } object's (HungryNerd's) constructor, which can use 
i i +2 . the member variables (since they ve been 
void think() ( myIQ += 10; } dii 
}: 


This code is automagically 
added by the compiler! 


class HungryNerd { 
public: 
HungryNerd() 


care 
Call myBelly 's default constructor y myBelly myGos| Q | 
Call mvBrain's default constructor 


( myBrain|myTQ 


myBelly.eat(); 
myBrain.think(); 


Member 
objects 


int main() 
{ 


private: 
Stomach myBelly; 
Brain my Brain; 


HungryNerd carey; 


} 


class Stomach { So how does destruction work 


ublic: 7 
p Stomach() ( myGas = 0; ) when we use class composition? 
void eat() ( myGas qe } * At the time when our object (carey) goes out of 
“ iT scope, C++ automatically calls its destructor. 
}: ~Stomach() { cout << “Fart!\n": } * C++ always runs the main/outer object's destructor 
first. It's member variables are still valid when the 
. outer destructor runs. That way, the outer 
class Brain ( destructor (~HungryNerd()) has access to completely 
public: valid member variables (myBelly and myBrain) while it 
; runs. 
Brain() { myIQ = 100; } e After the outer class's destructor runs (and has its 
^ ^ - . last meal and thinks its last thought, using valid 
void think() { myIQ ii 10; J myBelly and myBrain member variables), then C++ runs 
. ^Brain() ( cout << Arghl^n : } the destructors of the member variables in the 
Y reverse order they were constructed. 
* So first ~HungryNerd() will run, then ~myBrain() will 
us HungryNerd { run, and finally ^myBelly() will run. 
UDIIC: 
~HungryNerd() 
{ 
myBelly.eat(); ^ // last meal myBelly 


myBrain.think(); // last thought 


myBrain 


private: 
Stomach myBelly; 
Brain my Brain; 
p 


int main() 
( 


HungryNerd carey; 


) // € carey's destructor is called here 


class Stomach { * How does this actually work under the hood? 


public: * C++ secretly adds code AFTER the END of the outer 
at destructor to call the member objects destructors 
Stomach() myGas ~ O; } (in reverse order of their definition in the class). 
void eat() { myGas T } * The outer destructor runs first - it can still use all of 
" I\ pil: its member variables! 
}: ~Stomach() { cout << “Fart!\n": } * Then C++ calls the d'tors of the inner objects (first 


destructing myBrain with ^Brain() and then destruting 
myBelly with ~Belly()) 
class Brain ( - And of course, if an embedded object (like myBelly) 
public: has its own embedded object(s), this process is 


Brain() ( myIQ - 100: ) repeated. 
void think() { myIQ += 10; ) 
5, ~Brain() { cout « “Arghl\n"; L 


class HungryNerd { 
public: 


~HungryNerd() 
{ 


Argh! 
Fart! 


myBelly.eat(); ast meal 


myBrain.think(); // last thought l- xeu E. 


Call myBelly s destructor 
private: 
Stomach myBelly; 
Brain my Brain; 


}: 


int main() 
{ 


HungryNerd carey; 


Multi-level Composition Construction/Destruction 


class Food . Here's the order the c'tors will run for three levels of classes: 


( 
public: 


. Before Nerd() can run, C++ needs to construct its myStomach variable so 
the Nerd() constructor can use the member variable! So it transfers 
control to Stomach() to run first. 

. But before Stomach() can run, C++ needs to construct Stomach's myFood 


Food() Ber variable, since the constructor may need this variable to properly run! 
e So Stomach() transfers control to Food(). 
~Food() * . The Food() constructor is able to run immediately, since the food class has 


no embedded member objects. So Food() is technically the first 
constructor to run when we create a new Nerd (Green #1). 

. Once Food() runs to initialize myFood, it returns to Stomach() which may 
now run second (Green #2), since now it's myFood member variable has 
been constructed. 

. Finally, Stomach() finishes and returns, so now our Nerd() constructor can 
run (and use its myStomach variable normally) to construct david s (Green 


class Stomach 


( 
public: 


#3). 
Stomach() ° Here's the order the d'tors will run for three levels of classes: 

~Sto mach() ° First ~Nerd() runs (Red #1). It needs to run before myStomach's 

; : destructor because it may need to use myStomach, and if myStomach was 

private: destructed before ~Nerd() runs, that would be impossible. 

Food myFood; * . Once ~Nerd() has finished, C++ secretly calls the myStomach destructor 

: ~Stomach(). 
X ° ~Stomach() runs completely (Red #2) destructing myStomach, and once it's 
done, C++ secretly calls the myFood destructor ~Food(). 

class Nerd *  ~Food() destructs myFood last (Red #3) and finally the entire Nerd and all 
{ of its contents have been destroyed. 


. C++ Can now free the memory associated with the david s variable and its 


publi C: contents back to the operating system. 
Nerd() (8 — 
~Nerd() e INT Maint) 
private: 


Stomach 


myStomach; 
X 


EUR Back to Auto-generated 


{ 
public: 


Fins Cane ie ieee iene on. aie Constructors and Destructors 


void celebrate () 


: * Inthe class on the top-left, we didn't define any 


myBelly.eat(); // mmmm 
) constructors or destructors for our HungryNerd 
private: class 

Belly myBelly; 3 . 

Brain myBrain; * As we learned, if you leave out a constructor 


E and/or destructor, C++ auto-generates an empty 


constructor and/or destructor for your class and 
injects them into your compiled program, as 
class: HongsgMerd Shown on the middle-left. 
public: * . But if those auto-added c'tors/d'tors have empty 

Hungryiierd() // implicitly added by compiler { bodies} why would C++ add them? 

// empty * Well, as we learned, if a class uses composition 

and has member objects inside of it (like myBelly 
or myBrain), then it also needs to construct/ 


) 


^HungryNerd() // implicitly added by compiler 


destruct those member objects at the right 


l // empty time. 
e Soin addition to simply adding a dummy 
void cabebrate( constructor, C++ also adds code to it to first call 


t class HungryNerd the default constructors of all member variables 


Ap when the outer class is constructed (green) 
HungryNerd() // implicitly added by compiler | * And when it adds a dummy destructor, C++ also 


E rat E adds code to the end of it to call the 
f NS destructors of the member variables (in the 
) reverse order of construction) when the outer 
Ito NUM // implicitly added by compiler| object goes away (in red). 

// empty e This ensures that by the time your other 

Call myBrain's destructor member functions use your embedded object 


Call myBelly's destructor variables, they'll be properly initialized! 


myBelly.eat() ; 
} 
private: 
Belly myBelly; 
Brain myBrain; 
); 


void celebrate () . . 
( * And it ensures that when your outer object goes 
COMME T M away, its embedded object variables will be 
private: destructed tool 
Belly myBelly; 
Brain myBrain; 


}; 


Back to Auto-generated Constructors and Destructors 


class HungryNerd * Just be carefull 
* Remember, that the auto-added 


default constructor WON'T 
initialize your primitive member 


HungryNerd() // implicitly added by compiler variables (e.g., ints, bools, floats, 
Call myBelly's default constructor doubles, etc.)! 
Call myBrain's default constructor * Inthe class to the left, myAge 

{ would be such a primitive variable. 


// empty 


{ 
public: 


e So if your class has any primitives 
you should define your own 
constructor and initialize them! 

~HungryNerd() // implicitly added by compiler|* Otherwise they'll have essentially 

{ random values. Whatever was in the 
// empty RAM before the variable was 

created will be the value of the 


} . 
Call myBrain's destructor variable. 
Call myBelly's destructor 


void celebrate () 


cout << “Happy “ << myAge << 


} "^th birthday!” ; 


private: 
Belly myBelly; 
Brain myBrain; 
int myAge ; 


Advanced Class Composition 


Of course, things are never quite so simple... 


Let's look at a slightly more complex 
class composition example. 


Let's change the constructor of our Stomach class so it 
REQUIRES the user to specify the amount of gas each 
stomach starts with. 


Ok, so now our new 


Advanced CI Stomach constructor 


class Stomach REQUIRES us to 
pass in a value... 


ition 


public: , , 
Stomach(int startGas) int main() 
{ 


{ 
myGas = startGas; Stomach a(5); // 5 farts 


[4 


} 


~Stomach() { cout << “Fart!\n"; } 
void eat() { myGas ++: } 


private: 


int myGas; } 


a.eat(); // 6 farts 


p 


* Inthe previous examples, when we used class composition, our member variables had 
default constructors (i.e., constructors that don't have/require any parameters). 

* But what happens if one of our member variables has a constructor that REQUIRES 
parameters be passed to it. 

e For example, take a look at this updated Stomach class that requires the amount of gas 
the stomach starts with to be passed in. 

e As you see on the right, now we have to pass a value (like 5) in to construct a new Stomach 
variable. 

e Stomach no longer has a default constructor to call! 

* . Now, what happens if we want to use our new Stomach class in our HungryNerd class? 


Advanced Class Composition 


class Stomach class HungryNerd 
{ 


public: 


Stomach(int startGas) 
{ 


public: 
HungryNerd() 
{ 


myGas = startGas; myBelly.eat(); 
) myBrain.think(); 
~Stomach() { cout << “Fart!\n"; } } 
void eat() { myGas ++: } 
private: 
int myGas; 
private: 
Stomach myBelly; 
Brain myBrain; 


X 


Will our HungryNerd class still compile? 


Advanced Class Composition 


class Stomach class HungryNerd 


S T 6 public: 
ias (int startGas) HungryNerd() 


- i Call myBelly's default constructor 
) myGas = startéas; Call myBrain's default constructor 


{ 


~Stomach() { cout << “Fart!\n"; } myBelly.eat(); 
void eat() { myGas ++; } myBrain.think(); 
} 


private: 
int myGas; 
}: private: 
Stomach myBelly; 
Brain myBrain; 


e The auto-generated code that C++ adds to construct the member variables (green box on right) 
before the outer constructor runs always calls default constructors, which take NO parameters! 

* But our new Stomach class doesn't have a default (parameter-less) constructor anymore! If you 
want to construct a Stomach variable you have to pass in a value to its constructor. 

e So this results in a C++ compilation error, since there's no default constructor in Stomach for C++ 
to call in your HungryNerd constructor. 

* In these cases (where a member variable requires a parameter to be constructed), we have to 
explicitly add some code to our constructor to call the member variable's constructor and pass in 
valid parameters. 


Advanced Class Composition 


class Stomach class HungryNerd 


public: 


Stomach(int startGas) 
{ 


public: 
HungryNerd() 
: myBelly(10) 


Call myBrain's default constructor 
( 


myBelly.eat(); 


myGas = startGas; 
} 
~Stomach() { cout << “Fart!\n"; } 
void eat() { myGas ++: } 


private: 
int myGas; 
y 


myBrain.think(); 


private: 
Stomach myBelly; 
Brain myBrain; 


Alright, let's see the "exciting" C++ syntax! 
We're no longer going to let C++ call Stomach's default constructor for us, since Stomach doesn't have a default c'tor! 
Instead, we'll add our own C++ code to explicitly call myBelly's constructor with a parameter. 
Notice the new code in green/red that the programmer has to add between the outer constructor's prototype and the ( 
that starts its code block: 
: myBelly(10) 
* This new code is called an "initializer list". We use an initializer list to explicitly construct the myBelly variable by 
passing in a value of 10. Now C++ won't try to call the default constructor. 
* Theinitializer list explicitly calls the member variables constructor and passes in the required values. 
* As before, we can still rely upon C++ to implicitly call the constructor for myBrain (green box), since it still has a default 
constructor. 


Advanced Class Composition 


class Stomach class HungryNerd 


public: . ublic: 
Stomach(int startGas) R HungryNerd() 


t dits body :m Ilv(10 
= : myBelly(10) 
} my ee starteas, Call myBrain's default constructor 
( 


~Stomach() ( cout << "Fart! An"; } myBelly.eat(); 
void eat() ( myGas ++: ) myBrain.think(); 
) 


private: 


int myGas; 
}: private: 
Stomach myBelly; 
Brain myBrain; 
}: 


* Any time you have a member variable (e.g., myBelly) that requires one or more parameters for construction... 

* You must add an initializer list to all of your outer class's constructor(s). 

* The initializer list sits between the constructor's prototype (HungryNerd() in this case), and its open bracer {. 

* The initializer list starts with a colon, followed by one or more member variables and their parameters in parentheses. 


din Stomach Advanced Class Composition 


public: 


Stomach(int startGas) class HungryNerd 
( 
( 


myGas = startGas; public: 


HungryNerd() 
: myBelly(10) 

{ 
myBelly.eat(); 
myBrain.think(); 


~Stomach() { cout << “Fart!\n"; } 
void eat() { myGas ++; } 


private: 


int myGas; 


class Brain 
private: 


Stomach myBelly; 
Brain myBrain; 


X 


( 
public: 


Brain() ( myIQ = 100; ) 
void think() ( myIQ += 10; ) 


int main() 


* So when we construct our HungryNerd (carey), 
the first thing that happens is HungryNerd's 
initializer list calls the constructor for its 
myBelly Stomach variable and passes in 10. 

* Then the implicitly added code calls myBrain's 
default constructor (as it did before) 

* Finally, HungryNerd's constructor runs last, 


carey 


HungryNerd carey; 


allowing carey to .eat() and .think(). 


class Stomach 


public: 
Stomach(int startGas) 
{ 


myGas = startGas; 


class Brain 
{ 
public: 
Brain(int startIQ) 
{ 


myIQ = startIQ; 
} 


Advanced Class Composition 


class HungryNerd 
{ 


public: 
icu indt. 
elly(10) , myBrain(150) 


myBelly.eat(); 
myBrain.think(); 


private: 
Stomach myBelly; 
Brain myBrain; 


void think() ( myIQ += 10; } }; 
int main() 
* We can also use the initializer list to initialize more than just one 
member variable! I 
* For instance, let's assume we changed our Brain class so it requires the HungryNerd carey; 


initial IQ value to be passed in (see just above) 

* Now we would be required to update our initializer list to explicitly 
initialize both myBelly (in this example, with a value of 10), and myBrain 
(in this example, with an initial IQ of 150) 

* Notice that we separate each item in the initializer list with a comma. 


Initializer Lists 


e If you like, you may also use the initializer list to initialize your primitive member variables too. 

* For instance, in the example below, our HungryNerd now has a myAge integer member variable 

e We now use the initializer list to set its value to 19. This ensures the myAge variable is initialized before 
the actual { body } of the constructor runs. 

e You can initialize these primitive member variables either using the initializer list or just inside the body of 
the constructor as we've done in the past: myAge = 19; 

e It's up to you (or the company you work for) to pick an approach and standardize on it. 


class HungryNerd 


{ 
public: 


HungryNerd () 
myBelly (10), myBrain (150), myAge (19) 


myBelly.eat() ; 


private: 
Belly myBelly; 
Brain myBrain; 
int myAge; 


Advanced Class Composition 


class Stomach class HungryNerd 
{ 


public: 


Stomach(int startGas) pue 
( 


HungryNerd( int startinaGas) 
: myBelly( startingGas*4) 


Call myBrain's default constructor 
( 


myGas = startGas; 
} 
~Stomach() { cout << “Fart!\n"; } 
void eat() { myGas ++: } 


private: 
int myGas; 
p 


myBelly.eat(); 
myBrain.think(); 


private: 
Stomach myBelly; 
Brain myBrain; 

}: 


* Finally, there's no reason why the parameters to your 
initializer list have to be constants... 
* You can pass any value or expression you like to your 


variables in the initializer list. int main() 

* Inthis example, we pass in the starting amount of gas 
to our HungryNerd constructor, and then our 
initializer list passes this value * 4 along to the HungryNerd carey(75); 
Stomach constructor when constructing myBelly. 

* Soour myBelly variable would start out with 300 units 
of gas. 

* Oh man, that must smell. } 


A Few Final Topics 


Let's talk about four final topics that you'll need in 
order to solve your Project #1... 


Debugging 


SPENT 54 HOURS DEBUGGING P1 


Learning to Use the C++ Debugger 
What's the big picture? 


Visual Studio/Xcode debuggers help you find 
bugs 10x faster! 


You can trace programs line-by-line and see the 
value of every variable (like we do in slides)! 


Debug Tools Window He 
gx -aaje-e-I» 
(225i) a|> Sas 
xe 'ead: 


It takes about 10 mins to learn how the Visual 
Studio/Xcode debuggers work, so get going! 


Debugging 


By default, Visual Studio compiles all programs in “debug mode" so 
you can use the debugger with them right away. 


File Edit View Project Debug Tools Window Help 
Pale a- d di&a -c0-|» [Debug ~| | Win32 
(03 Re ae | = 2 


(od Solution 'test1' (1 proj 
4 Bi testl 
fal External Depenc 
3i Header Files 
(i Resource Files 
4 | Source Files 
€] test.cpp 


When you compile your 
program, you should see 
"Configuration: Debug Win32" 

in the Output window. 


lint main() 


int a = 10; 


int b = 5 * a +.42; 


cout << "The result is " << b << endl; 


L} 
100% v 4 


Output 


Show output from: | Build ] s g . 

------ Build started: Project: test1, Configuration: Debug Win32 ------ 
test.cpp | 
testl.vcxproj -> C:\Users\Carey Nachenberg\temp\test1\Debug\test1.exe 

========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ========== 


Debugging 


You can run your program from start to finish by hitting either 
F5 or Ctrl-F5. 


f 8 ' C\Users\Carey Nachenber... - 

The result is 92 If you run your program by hitting 

- F5, Visual Studio will immediately 

close the debug window after your 
program finishes. 


Press any kou i continue . . . = If you run by hitting Ctrl-F5, 
Visual Studio will print 
“Press any key to continue..." 
and leave the debug window on the 
screen when your program 
completes. 


Debugging 


To start your program and debug one line at a time, hit F10 after you 
finish compiling it. 

You can then continue stepping through your program one statement at 
a time using the F10 and F11 keys. 

When you first start debugging your program by hitting F10, you'll see 
the little yellow arrow next to the first line of your program (see 
upper-right corner). The arrow points to the line of code that's 
ABOUT to execute (that line hasn't been run yet). 

Hitting F10 again takes you to the first line inside the function (see 
middle-right) 

Notice that Visual Studio has a sub-window where it displays the 
values of your active local variables - these are called "auto? variables. 
Since we haven't run the current line of code yet (a = 10;) to inthe 
value, a is currently random: 

If we trace once more by hitting F10, we'll run the a=t6;-ste 
see that a's value is now 10 (hi-lited in red because the value changed) 
Also notice that variable b is 
since the line b= 5 * a+ 42; hasnt 
If you were to hit F10 again, then b's vàtue would change to 92 and be 
shown in red. a's value would stay 10, but no longer be highlighted. 
This ability to see every variable's value one statement as a time is 
super powerful for debugging. Use it and save 8075 of 
development time - really! 


lir Process: | [3988] testl.exe 


EX E 
1 Process: | [3988] testl.exe 


IX [zi 


(De 
file Edit View Project Debug Jools Window Help 
"u-udgdit-aale-ec-I» 
3X s|[z?.ibalo»"üg*lise |3 
~ | Thread: | [3992] Main Thread 


Solutio 
allg 


(23 Solution 'testl (1 project) 
^ testi 
§ External Dependenci 
Ga Header Files 
Gi Resource Files 
a @ Source Files 
Q) testcpp 


RTStartup() Line 555 + 0x19 bytes e E 
testLexelmainCRTStartupÜ Line 371 


Eile Edit View Project Debug Jools Window Help 
"u-uddi&-aa^-c-I» 
bajoa ine ià3-. 


~ Thread: | [3992] Main Thread 


G3 Header Files 
Ca Resource Files 
^ @ Source Files 
€] testcpp 


Lan 

Ced 
testLexel_tmainCRTStartup0) Line 555 + 0x19 bytes E 
testLexelmainCRTStartup() Line 3 


Projet Debug Tools Window Help 
--3uddis-asi^-c-i* 
bajo a aine l e 


Process: (3988) testl.exe ~| Thread: | (3992) Main Thread 


wa | | GJ 


A Solution 'testl (1 project) 
T testi 


(Global Scope) 
int main() 


ipi External Dependenci int a = 10; 
(i Header Files 
G Resource Files 


Source Files 


intb-5*2«42j 


cout «« "The result is " 


10 
-858993460 


File Edit View Project Debug Tools Window Help 
ba aduddia-aaie-c-|» Win32 a -ISC 
PQS 25m alo *|»s|32-.] 

Í Process: | [3988] testLexe ~| Thread: | [3992] Main Thread “ewe 


Debugging 


While you're tracing through your code, you may wish to 
look at other variables (like member variables) or even 
evaluate more complex expressions (e.g., 10 * a + 7) 


(Global Scope) 
int main() 


aii 
A Solution 'test1' (1 project) 
+ Ttesti 

SA External Dependencil 

à Header Files 
Ca Resource Files 

^ @ Source Files 
3 testcpp 


int a = 10; 


int b s5 * a+ 42; 


cout << "The result is " << b << endl; 


To do this, click on the Watch tab. Seto ease Uno € d 


This will bring up the "Watch" window which allows you to 
evaluate any variable or expression. 
Click the mouse on the blue line in the m 
type in a variable name or expression to watchxe.g. He ER, Men, a Lic Mew iM l 
* . i Jed id á a AlI- ~|d be wi 
b a*5. Then hit enter. 5 m zt Jd alo ELE E 
Now the Watch window will display the value of your 
expression! DIEI IIT — 


^ (testi t 


AS your code changes the values of variables hat would T | 


Za Resource Files int b= 5 * a + 42; 


impact the expression (e.g., a or b), the resultins , E eee 
will change automatically! 


int a - 16; 


lan ^ 
> testLexelmain() Line 11 C++ 
testlexe! tmainCRTStartup() Line 555 + 0x19 bytes C |= 
testLexelmainCRTStartup0 Line 371 c 


file Edit View Project Debug Tools Window Help 
PEFR ed BB a9 ~~] ded Win32 a -E 
Á Rie lS2 sib a) > 2 [ne |3 


3988] testLexe ~| Thread: | 3992] Main Thread 


~| * main0 


C Header Files 
G Resource Files 
^ @ Source Files 

& testcpp 


cout << "The result is " << b << endl; 


Name 
> testLexelmainü Line 11 Ce 
test1exel_tmainCRTStartup() Line 555 + 0x19 bytes C. |= 
es inCRTStartup0 Line 371 c 


D € b U g g i ng a | C:\Users\Carey Nachenberg\temp\test1\De... | 


c has a Value of: 10 


The and keys actually do slightly different - 
things... Let's discuss F10 first. F10 means “TRACE OVER" 
If you hit while on a function call line, Visual Studio 
will run the entire function in one step. It will trace over 
all of the statements in that function in one step (even if 
there are millions of steps). You won't be able to trace 
line-by-line through the function. 

So lets you quickly run a line of code that calls a 
function without having to trace through the function. 
Hitting F10 on the foo() line, as shown in the window 
below, would run the entire foo function from start to 


finish, producing the output shown in the upper right-hand 
console window. 

Then Visual Studio would place the cursor on the line 
following the function call (as shown in the lower right- 
hand image), where you can continue tracing. 


" — r —— 
=] test1 (Debugging) - Microsoft Visual C++ 2010 Express ca =] test1 (Debugging) - Microsoft Visual C++ 2010 Express (= Te 


File Edit View Project Debug Tools Window Help File Edit View Project Debug Tools Window Help 


-|> 2 . zl ly 5 udis zm V E] -Ma 
BCE Ms | Hex 3v Chae |S 2 iD | > See [ne | 
| Thread: | [3344] Main Thread | ew: Process: | [3916] testLexe ~| Thread: | [3344] Main Thread Jv ws 


Solution Explorer MESESE testcpp x 


iS EE] (Global Scope) ~| Y main) 
J Solution 'test1' (1 project) 
4 [testi 

ii External Dependenci 

@ Header Files 

@ Resource Files 
a | Source Files 

€ test.cpp 


(Global Scope) 


j Solution 'test1' (1 project 
4 Witestl 
fi External Dependenci| 
Œ Header Files 
(ij Resource Files 
a iz Source Files 
€ test.cpp 


foo() foo() 


c = 10; 


c= 10 3 
cout << "c has a value of: " << c << endl; 


cout << "c has a value of: " << c << endl; 


main() main() 


a = 10; a = 10; 


foo(); 
cout << "a has a value of: " << a << endl; 


foo(); 
cout << "a has a value of: " << a << endl; 


MESES Call Stack 


Name Lan ^ 


~ AX Call Stack 
Name Lan ^ 
=| testl.exe!main() Line 15 Cu 
testl.exe!_tmainCRTStartup() Line 555 + 0x19 bytes |C 
testl.exelmainCRTStartup Line 371 C 


-»| testLexelmain() Line 16 C+ 
testlexe! tmainCRTStartup() Line 555 + 0x19 bytes |C 
testl.exe!mainCRTStartup0 Line 371 E 
kernel32.dll!761133a 


FA Locals EP Threads BB Modu... BA Watch... EREETESCSS We Breakpoints BI Output FA Locals Threads EB Modu... 


Debugging 


Let's discuss F11 next. F11 means “TRACE INTO" 

If you hit F11 while on a line that contains a function call, 
Visual Studio will let you step into that function and trace 
through that function's statements a line at a time. 

So let's say you're debugging your program and are about 
to call the foo() function (see upper right corner) - look 
for the yellow arrow next to the green vertical bar. 

If you hit the F11 key, this will take you into the foo() 
function and let you step through its statements a line at 
a time, as shown in the bottom right (notice the yellow 
arrow is on the int c = 10; line). 

You can then trace using either F10 or F11 through the 
foo function. If foo calls another function, you can use 
F11 to step into that function's logic as well if you like. Or 
just F10 to step over its code. 

When the foo function finally returns, you can continue 
tracing at the cout << "a has a value..." line. 

So... use F10 if you want to run a function but skip over 
the line-by-line debugging. Use F11 if you want to do in- 
depth debugging of a function call. 


Í Process: | [3916] test1.exe 


| Ele Edit View Project Debug Tools Window Help 


J-A- Gdg) 3| - C -| D [Debug 
Ra |= 2] > a | > Fe Gees | Hex [C3 . 


~| Thread: | [3344] Main Thread 


Solution Explorer MESESE test.cpp x 


Là YE] (Global Scope) 


-| ** main0 


A Solution 'test1' (1 project) 


void foo() 
{ 


&A External Dependenci| 
Header Files 
Œ Resource Files 
4 @ Source Files 
€ test.cpp 


int c = 10; 
} 
Sint main() 
int a = 10; 


foo(); 


cout «« "a has a value of: " 


cout «« "c has a value of: " 


<< c << endl; 


<< a << endl; 


File mls View Project Debug Tools Window Help 
-u ed | & ca A | ~ 9 -| b [Debug 
ae 22 J a|> Sires] ETE E 
Í Process: |[3140] testL.exe — ~| Thread: | [2248] Main ` Thread 


Name 


-»| test1exelmain( Line 15 


test1.exe!_tmainCRTStartup() Line 555 + 0x19 bytes |C 


testLexe!mainCRTStartup0 Line 371 


(Global Scope) 


-| ** foo0 


A Solution ‘test1' (1 project) void foot) 
& External Dependenci/ 
Header Files 
Resource Files 

4 @ Source Files 
€ test.cpp 


int c = 10; 
i 
Sint main() 
int a - 10; 


foo(); 


cout «« "a has a value of: " 


~ 4X Call Stack 
Value 
-858993460 


DE EEN F Locals E Threads E Modu... BA Watch 


cout << "c has a value of: " 


<< c << endl; 


<< a << endl; 


Name 


|»|testLexe!foo() Line 7 
testlexe!main() Line 16 


testlexe! tmainCRTStartup() Line 555 + 0x19 bytes e 


testl. exelm 
kernel3. 
e Call Stack 


RE TStartup() Line 371 


«points Bl Output 


Chi 


Debugging 


If at any time while you're tracing 
line-by-line you want to stop 
tracing line-by-line... 

And simply let the rest of your 
program run normally... 

Just hit F5 and Visual Studio will 
run your program until completion! 
Be careful... your output window 
will immediately disappear after 
the program finishes running, so it 
might look like it's not working. 

If you hit CTRL-F5 instead, that 
will run your program and stop the 
terminal window (the black window 
shown here in the upper left) 
from disappearing once the 
program finishes running. 


ll "POouoeC«-(5:!'IOQUl!OOILLbLEUSEOÉEOSULOO 
8 | C:\Users\Carey Nachenberg\temp\test1\Debud\... _— ih 


c has a Value of: 
a has a Value of: 


File Edit View Project Debug Tools Window Help 
paly Gly 5 ted dil ca | ~ 0 ~| Dd [Debug 


iG) Ra |S 2 5 


auno wawn20q gE 


Solution Explo.. ~ 4 x EGG EEA 


kà à I] (Global Scope) ~| Y main0 
U g mamespace 


2 Solution 'test1' (1 proj 
4 Witesti 
E External Depend 
L3i Header Files 
(i Resource Files 
4 (| Source Files 
€ test.cpp 


“void foo() 


int c = 10; 
cout «« "c has a value of: " «« c «« endl; 


3 
Jint main() 
int a = 10; 


foo(); 
cout «« "a has a value of: " «« a «« endl; 


iI 


Show output from: | Debug x n e ME A 2] 
'testl.exe': Loaded ‘C:\Windows\SysWOW64\KernelBase.d1l1', Cannot find or open the PDB file 
'testl.exe': Loaded ‘C:\Windows\SysWOW64\msvcp10@d.d11‘, Symbols loaded. 

'testl.exe': Loaded ‘C:\Windows\SysWOW64\msvcr1@@d.d11‘, Symbols loaded. 

The program '[3656] testl.exe: Native’ has exited with code 0 (0x0). 


e u Q g | n Q File Edit View Project Debug Tools Window Help lI 
" i 


Pdl-zd-02 d X -a|9 -C -|» [Debug 


Sometimes you'll want to start debugging deep within your — - 

program. Like in the program to the left - there's a 10 million 8-52 g 

iteration loop before the important computation that divides Hen ene d 
cos/atan that I want to debug. LES "s 

You don't want to step through millions of lines to reach the raining se e a a | 


likely location of a bug. What should you do? double 2 = cos(10.0) / atan(20.0); 

Answer: Add a breakpoint to your program. RUP wens) En 

A breakpoint is a tag that you add to a line in your program that i] a 

tells the debugger to stop when it hits that line. i — — m 

: . : F . Show output from: | Build ad || 

To add a breakpoint, click the mouse on the line where you'd like SC MEM MERCI a 
" » " testl.vcxproj -» C:\Users\Carey Nachenberg\temp\test1\Debug\test1.exe z 

To Start debugging and hit The F9 key. You ll see a red ball show ========== Build: 1 succeeded, @ failed, 0 up-to-date, 0 skipped ========== 

up next to the line. ! | 


Then just hit the F5 key to run your program from the star 


until it reaches that linel Your program will run potentially — z 
millions of instructions in seconds until it hits the breakpoint. File Edit View Projet Debug Tools Window Help 
manene i3 a | Debu -Wwin = g i 
Then the debugger stops the program, shows you the yellow Sio E EB LATUS vs 
. " . . E PN ~ S865 
arrow, and lets you trace line-by-line using F10 and F11 just like PEETHI— 
before. s ES IE (Global Scope) -| ** main0 
D Soluttgn 'test1' (1 proj Jint main() ES 9 A 
4 [test A 
2 él ExteNal Depenc int i; 
© HeaderNiles 
— = Pa Resource Nes for (i = 0;1<10000000; i++) 3 
File Edit View Project} Debug Tools Window Help i R a it doSomething(); 3 
Pdl-cd-02 d Bd -ad|9-c0-|»b | Debug Win32 I | 9 double z - cos(10.0) / atan(20.0); 
PO Sha |S 2 dip a | > Se Ge ane l| cout << "The value is: " << z << endl; 
1 Process: | [3384] testl.exe ~| Thread: | 11360) Main Thread M B $ 
E == = = = — — 100 % hd MIT —— - "m — —— J > 
... Ba m | 
preme (1 project) = 3 porem = | Show output from: |Build -| ə | MJES zx | "n 
4 Witesta - test.cpp ^ 
fl External Dependenci| dnb Se testl.vexproj -> C:\Users\Carey Nachenberg\temp\test1\Debug\test1.exe mI 
© Header Files T ========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ---------- 
© Resource Files for (i = 0;i«10000000; i++) n 
a @ Source Files doSomething(); E 4 [m DN EN " j » 
€] test.cpp — n 
© | double z = cos(10.0) / atan(20.0); ad 
cout << "The value is: " << z << endl; — M. ——Ó -— —M | 
J ` E ` E ` 
l ||| * Or if you like after debugging a few lines, you can hit 
1 % i iti, x . . . . . 
TET , F5 again and your program will run until it hits the 
ame alue |Type ^ lame an^ i i 
ae eszenan ue; cv} breakpoint again. l l 
NNNM : j tee imancitsarund une sss s « Oh and you can add as many breakpoints as you like... 
«[— am] E E Z 3 G23 Call Stack = ! 
Not just one! 


Debugging with Xcode 


The SUPERIOR IDE © 


(Xcode debugging slides graciously 
created by Devan Dutta!) 


Debugging with Xcode 


This is Xcode's code editor. Xcode is an IDE created by Apple, 
specifically for iOS, macOS, tvOS, and watchOS development, but it 
also comes fully loaded with C and C++ support. 


eee > Wülcs.o ) ES MyMac — cs32 lecture2 demo | Build Succeeded = Qe l = I 
B&R A = < È cs32_lecture2_demo ) $ cs32 lecture2 dem m pp ) EJ main( g t char * argv[]) 
B cs32 lecture 2demo j= | ! finc lude <iostream> 
v Mics ture2. demi using namespace st d 
3 ( g ar * argv[]) d 
o mi PP 10 
> D Prod 
b=5 42; 
< "Thi sult b 1 
return ð; 


When you compile your program, you'll 
see an empty debug output window... 


The “Auto” means that the sub- 
window will automatically track 
and show new variables. 


Debugging with Xcode 


You can run your program from start to finish by going to: 
Product > Run 


Xcode also has 
shortcuts © 


€ Xcode File Edit View Find Navigate Editor 


Debug Source” gtrol Window Help 


eee P> W cs..o ) Ed My Mac cs32 lecture2 de = | © 
d E 
EJ z Qa AO =D ØH cs32_lect Profile $61 10) c. main.cpp main(int argc, 
Y 3 cs32_lecture2_demo #include <iostre e eae 
1 rcnive 
Y  .cs32 lecture2 demo ud Masculina 
3 int main(int arg 2 
pp int a = 10; Build For > 
P. Products Perform Action > 
COPI" Raid  — 88] 
cout << "The Clean HK 
return 0; 
} 
Scheme > 
Destination > 


Create Bot... 


Debugging with Xcode 


You can also step through your program, one line at a time. 


Let's insert a breakpoint at line 3. 


#include <iostream> 
using namespace std; 
3 int main(int argc, const char * argv[]) (| 


} 


int a = 10; 


int b=5 * a + 42; 


cout << "The result is: " 


return 0; 


«« b «« endl; 


Just tap on the 
gray space next to 
the 3. 


Debugging with Xcode 


You can also step through your program, one line at a time. 
Let's insert a breakpoint at line 3. 


s #includ iost 
The blue arrow on line 3 shows a ee 
p . : using namespace std; 
that our breakpoint IS active. int main(int argc, const char x argv[1) { 


int a = 10; 


int b = 5 * a + 42; 


If we click on the breakpoint 
again, we deactivate it, but 
Xcode remembers that we 
had a breakpoint there and 

will let us turn it back on. 

Neat! 


cout << "The result is: " << b << endl; 
return 0; 


} 


#include <iostream> 

using namespace std; 

int main(int argc, const char x argv[]) ( 
int a = 10; 


int b = 5 * a + 42; 


cout << "The result is: " << b << endl; 
return 0; 


Debugging with Xcode 


Because we set a breakpoint at main(), we can debug 1 line at a time. 


This 
screenshot to 
the right 
shows what an 
Xcode 
debugging 
session looks 
like. 


The left pane 
is showing 
resource 
usage. 


The right pane 
is the code 
being run. 


BiB RAQASCED plg 


Y MM cs32_lecture2_demo PID 19140 © (i) 


D cs32 lecture2 demo ) M cs32 lecture2 demo 


c+ main.cpp ) [fj main(int argc, const char * argv[]) 


#include <iostream> 


using namespace std; 


CPU 

(Z3 Memory 5.3 MB 

z Energy Impact Zero 

B Disk Zero KB/s 

@ Network Zero KB/s } 


v @ Thread 1 Queue: com.a...thread (serial) 
P omain 
1 start 
> (I) Thread 2 
> ([) Thread 3 


[y] m$ D ^ zt 


0% WEE int main(int argc, const char * argv[]) X 


int a = 10; Thread 1: breakpoint 1.1 


int b = 5 * a + 42; 


cout << "The result is: " 
return 0; 


<< b << endl; 


Xcode has stopped execution 
right after entering main(). 


The green-highlighted line is 
the line of code that's 
ABOUT to execute. 


{i 9o < W cs32_lecture2 demo ) (jj) Thread 1 ) [Fl] 0 main 


argc = (int) 1 (i1db) 
> argv = (const char **) Ox7ffeefbff5bO 
a = (int) O 
b = (int) O 
© TR Autos = All Output $ =) Qr (OO 


Debugging with Xcode 


Because we set a breakpoint at main(), we can debug 1 line at a time. 


EJ [3] z2 Q AO zo GE < © cs32 lecture2 demo ) $ cs32 lecture2 demo ) c. main.cpp ) EF] main(int argc, const char * argv[]) 
v lll cs32 lecture2 demo PID 19140 © (i) #include <iostream> 
using namespace std; 
CPU 0% NEED int main(int argc, const char * argv[1) X 
int a = 10; Thread 1: breakpoint 1.1 
(Z3 Memory 5.3 MB 
: int b - 5 a + 42; 
[+ Energy Impact Zero 
a Disk Zero KB/s cout << "The result is: " << b << endl; 
return 0; 
@ Network Zero KB/s } 


v (@ Thread 1 Queue: com.a...thread (serial) 


P omain 


1 start 


This window is our debug 
output. As we run cout 
statements, we'll see that 
output in this window. 


Our variable “watcher” has 
also indicated values for a 
and b. 


The aand b variables 
appear to be initialized, 
but in C++ you cant depend 
upon that to be the case. 
Always assume primitive 
values are uninitialized. 


Note: “Ildb" is Xcode's 
command-line debugger. 
Ignore it for now. 


[] m9 D > Lt f$ d) $99 <  Wics32 lecture2 demo ) () Thread1) FX \ 


argc - (int) 1 (i1db) 
argv = (const char **) Ox7ffeefbff5bO 


9 mE. Auto ¢ o All Output $ =) i (OO 


Debugging with Xcode 


Let's run the current line of code. 


BRmRirRrReQaAOzHZ GER X D cs32 lecture2 demo ) |^ cs32 lecture2 demo ) c- main.cpp main(int argc, const char * argv[]) 
v lll cs32 lecture2 demo PID 19140 © (i) #include <iostream> 
using namespace std; 
CPU 0% NEED int main(int argc, const char * argv[]) X 
int a = 10; = Thread 1: breakpoint 1.1 
( Memory 5.3 MB 
: int b 2 5 * a + 42; 
[> Energy Impact Zero 
fa] Disk Zero KB/s cout << "The result is: " << b << endl; 
return 9; 
@ Network Zero KB/s } 


v @ Thread 1 Queue: com.a...thread (serial) 
Po omain 
1 start 
> ([) Thread 2 
> (|) Thread 3 


This is the "Step Over" 
button (more on that later). 
For now, just tap on that to 
run the current line of code. 


[] E Pa 4 1$ d) $89 J | Wcs32lecture2 demo ) ([) Thread 1) FY 0 main 


GY argc = (int) 1 (11db) 
> [f argv = (const char **) Ox7ffeefbff5bO 

a = (int) O 

b = (int) O 


© m aE Auto $ © All Output $ € WW Hol 


Debugging with Xcode 


Let's run the current line of code. 


E3 [X] zz Q / Oo zoo GEHE C D cs32 lecture2 demo ) ^ cs32 lecture2 demo ) c. main.cpp main(int argc, const char * argv[]) 
v lll cs32 lecture2 demo PID 19140 © (i) #include <iostream> 
using namespace std; 
CPU 0% ED int main(int argc, const char x argv[]) { 
int a = 10; 
(CJ Memory 5.3 MB 
Ji int b = 5 * a + 42; - Thread 1: step over 
E Energy Impact Zero 
Ø Disk Zero KB/s cout << "The result is: " << b << endl; 
return 0; 
@ Network Zero KB/s } 


v @ Thread 1 Queue: com.a...thread (serial) 
m O main 


1 start 


But b hasn't changed yet. 
Let's press the "Step Over" 
button again. 


Check this out! The value for 
a has changed because we 
just executed the line of 

code to set a's value. 


£ dp $99 « | W cs32 lecture2 demo ) Q) Thread 1 ) P 0 main 


(11db) 
tar **) Ox7ffeefbff5bO 


mE] Auto? © All Output $ 


Debugging with Xcode 


Let's run the current line of code. 


Ej B] zz Q / GO Zz GER € cs32 lecture2 demo ) |^ cs32 lecture2 demo ) c. main.cpp ) EA] main(int argc, const char * argv[]) 
Y ll cs32 lecture2 demo PID 19140 (2) (i) #include <iostream> 
using namespace std; 
CPU 0% EBD int main(int argc, const char x argv[]) ( 
int a = 10; 
[Z3] Memory 5.3 MB 
- int b 2 5 * a+ 42; 
E> Energy Impact Zero 
a Disk Zero KB/s cout << "The result is: " << b << endl; — Thread 1: step over 
return ð; 
@ Network Zero KB/s } 


v @ Thread 1 Queue: com.a...thread (serial) 
.. Omain 
1 start 
> ([) Thread 2 


Now b has been updated, 
just as we expected! 


Tap on the "Step Over" 
button again to see the cout 
outpuf. 


[] Em Pea X 1$ d) So <  WHcs32lecture2 demo ) (]) Thread 1 ) P 0 main 


iS argc = (int) 1 (11db) 
nst char **) Ox7ffeefbff5bO 


G BB] | Auto e All Output $ © V | [LL 


Debugging with Xcode 


Let's run the current line of code. 


v Ml cs32 lecture2 demo PID 19140 (2) @ 


#include <iostream> 
using namespace std; 


E3 Dj zz Q / OG Zz vo ®@i m< cs32 lecture2 demo ) M cs32 lecture2 demo 


CPU 0% [RED int main(int argc, const char * argv[]) { 
int a = 10; 

C) Memory 5.3 MB 

E int b 2 5 * a+ 42; 

E> Energy Impact Zero 

B Disk Zero KB/s cout << "The result is: " << b << endl; 
return 0; 

@ Network Zero KB/s } 


v @ Thread 1 Queue: com.a...thread (serial) 


x 
b oman 


1 start 


> () Thread 2 


Notice that the debug output 
window now has the cout 
statement's result. 


BTW, this window can also be 
used for accepting user input! 


v m [DD 2 


> [4 argv = (const char **) Ox7ffeefbff5bO 


AY argc = (int) 1 
(Ba - (int) 10 
(B b = (int) 92 


9 WEB Autos 


hoy 


c. main.cpp main(int argc, const char * argv[]) 


— Thread 1: step over 


s32 lecture2 demo Q Thread 1 ) [Fl] 0 main 


result is: 92 
b) 


All Output ¢ © w | [1L 


Debugging with Xcode 


Let's use the Watch window to add an expression. 


Right-Click 
anywhere in the 
Watch window. 


Now click on Add 
Expression... 


[v] B DD ^ ecture2 demo ) (|) Thread 1 ) F| 0 main 


IÑ argc = (int) 1 The result is: 92 
> Œ argv = (const cl (11db) 
[Bj a = (int) 10 
b - (int) 92 ; 
Add Expression... 
V Show Types 
Show Raw Values 
» 
Auto > Sort By All Output > © 


[vy] B D o x 2 demo ) (l) Thread 1 ) P] 0 main 


IÑ argc = (int) 1 


lesult is: 92 
) 


> [AN argv = (const char **) 
a = (int) 10 
b - (int) 92 


Add Expression... 


V Show Types 
Show Raw Values 


Auto > Sort By > itput > © 


Wi ON i 


Debugging with Xcode 


Add an expression to watch 


Expression | b*a + 5| 


Show in All Sta 


Then type in a variable name or 
expression to watch. 


EB! Autos | O © 


@ 


Debugging with Xcode 


Add an expression to watch 


[p] e Pa Li 2/0 > <4 c2 
ZY argc = (int) 

p argv - (const char **) Ox7ffeefbff5bO 
[gj a = m b 10 
[I] b = (int) 


IE! b*a 5 - (int) 925 


And Xcode will display the 
value of your variable or 
expression in the "watch" 

window! 


Auto $ | © @ © 


Debugging with Xcode 


Let's revisit the “Step Over" 
button. Note the other button 
right next to it. 


This is the “Step 
Over” button (the 
button we have 
been using so far). 


he “Step Over" and “Step Into" 
buttons do slightly different 
things. Let's see an example. 


This is the “Step 
Into" button. 


Debugging with Xcode 


E3 tQ GOossDGI!IEH«X» cs32 lecture2 demo ) | ^ cs32 lecture2 demo ) c. main.cpp ) [2] main(int argc, const char * argv[]) 


v E c532 lecture2 demo PID 25572 (7) (i) 1 finclude <iostream> 

2 using namespace std; 

@ CPU 0% 3 
4 void foo() 

( Memory 5.8 MB 5 4 

ba z 7 7 7 6 int c = 10; 

7E peraympac pro 7 cout << "c has a value of: " << c << endl; 

Disk 6.7MB/s | 5 ! 

h ? 

@ Network Zero KB/s ECD int main(int argc, const char * argvt1) 
aM X 

v M Thread 1 Queue: com.a...thread (serial) 12 int a = 10; 


au — 
sm | foo; (— Thread t step over 


> (]) Thread 2 


16 cout << "a has a value of: " << a << endl; 
> (D Thread 3 17 return 9; 
> () Thread 4 18 } 


[] e p ^ 4 t$.) So FJ | NWcs32lecture2 demo ) () Thread 1 ) FY 0 main 


Üyargc-ün)1 — | (11db) E 
> [fJ argv = (const char **) Ox7ffeefbff5b0 
a= (int) 10 


| 
© mE] autos © | All Output $ © i [LU 


Debugging with Xcode 


EJ] lk] zz Q /AOzszoGIER 4 cs32 lecture2 demo ) | ^ cs32 lecture2 demo 
v ll cs32 lecture2 demo PID 25834 Q (il) #include <iostream> 
using namespace std; 
CPU 0% 
void foo() 
( Memory 5.3 MB { 
= " E a int c - 10; 
EE mpac ero cout << "c has a value 
E Disk Zero KB/s } 
@ Network Zero KB/s BED int main(int argc, const char * argv 
m 
v M) Thread 1 Queue: com.a...thread (serial) int a = 10; 
Domain 
1 start fontis 
> (D Thread 2 cout «« "a has a value of: 
> @ Thread 3 return 0; 
> (]] Thread 4 


And now our cursor is on the 


line after the function call. 


ZX argc = (int) 1 
Í argv = (const char **) Ox7ffeefbff5bO 
a = (int) 10 

© n Auto ¢ Ə) 


" << a << endl; 


c+ main.cpp fa main(int argc, const char * argv[]) 


Notice that Xcode ran the 
entire foo() function from 
start to finish... 


— Thread 1: step over 


= m9 bP 2 4 $5. dp 389 TZ  WÉÁcs32lecture2 demo ) (i) Thread 1 ) P 0 main 


c has a value of: 10 
(11db) 


All Output $ G 


= 
o 
m 


Debugging with Xcode 


Summary: 


If you hit “Step 
Over" while ona 
function call line, 
Xcode will run the 
entire function in 
one step. You won't 
be able to trace 
line-by-line through 
it. 


So "Step Over" lets 
you quickly run a line 
of code without 
delving into the 
details. 


Sem re a A OCB ec es 


v Ml cs32 lecture2 demo PID 25834 (2) (i) 


@ cpu 0% 
[2] Memory 5.3 MB 
m 

E Energy Impact Zero 
&g Disk Zero KB/s 
@ Network 


v @ Thread 1 Queue: com.a...thread (se 
O main 
1 start 
> (|) Thread 2 
> (]] Thread 3 
> () Thread 4 


THe 


Zero KB/s ED int ma 
MO 
erial) 


Auto > 


W < D cs32_lecture2_demo ) Ñ cs32 lecture2 demo 


#include <iostream> 
using namespace std; 


void foo() 


} 

in(int argc, const char * 

int a = 10; 

foo(); 

cout << "a has a value of: " << a << 
eturn 0; 


H 


e D > 4 £ 


v = (const char **) Ox7ffeefbff5bO 


i a- (int) 10 


c- main.cpp ) [fj main(int argc, const char * argv[]) 


- Thread 1: step over 


(] So < | Mil cs32_lecture2_demo ) (|) Thread 1 ) P 0 main 


c has a value of: 10 
db 


(11db) 


ij | OO 


All Output $ = l 


Debugging with Xcode 


Let's restart the debugger and use the “Step 
Into” button instead of “Step Over”. 


Just tap on the Stop 
button to stop the eoo > = H cs...0 My Mac Running cs32_lecture2_demo : c 


current debugging E3 = Q ff Stop the running Scene appicanoni cs32_lecture2_demo 
session. 


Then tap on the Run eoe ». MM cs..o ) Æ MyMac Finished running cs32_lecture2_ 
button to re-build 


and run the code. Ej L2 C Build and then run the current scheme cs32 lecture2. demo 


Debugging with Xcode 


E3 tQ GOossDGI!IEH«X» cs32 lecture2 demo ) | ^ cs32 lecture2 demo ) c. main.cpp ) [2] main(int argc, const char * argv[]) 


v E c532 lecture2 demo PID 25572 (7) (i) 1 finclude <iostream> 

2 using namespace std; 

@ CPU 0% 3 
4 void foo() 

( Memory 5.8 MB 5 4 

ba z 7 7 7 6 int c = 10; 

7E peraympac pro 7 cout << "c has a value of: " << c << endl; 

Disk 6.7MB/s | 5 ! 

h ? 

@ Network Zero KB/s ECD int main(int argc, const char * argvt1) 
aM X 

v M Thread 1 Queue: com.a...thread (serial) 12 int a = 10; 


au — 
sm | foo; (— Thread t step over 


> () Thread 2 


16 cout << "a has a value of: " << a << endl; 
> (]) Thread 3 17 return 9; 
> () Thread 4 18 } 


= e p ^ £ t$.) So J | Mics32_lecture2_demo ) () Thread 1 ) FY 0 main 


a argc - (int) 1 | (11db) E 
> [fJ argv = (const char **) Ox7ffeefbff5b0 
a= (int) 10 


| 
© mE] autos © | All Output $ © i [LU 


Debugging with Xcode 


E3 m QA 0 = GH:CGq D cs32 lecture2 demo ) M cs32 lecture2 demo ) c. main.cpp ) [fa] main(int argc, const char * argv[]) 


#include <iostream> 


v Ml cs32 lecture2 demo PID 26005 (2) (i) i 
using namespace std; 


CPU 0% 
void foo() 
[7] Memory 5.3 MB { 
- E | t Z int c - 10; — Thread 1: step in 
eee Impac pro cout << "c has a value of: " << c << endl; 
Disk Zero KB/s 
@ Network Zero KB/s | 10 int «t argc, const char * argv[]) 
"nk 
v M Thread 1 Queue: com.a...thread (serial) int a =) 
p FI 0 foo() 
B n foo(); 
2 start cout «« "a has a va << a << endl; 
> @ Thread 2 return 0; 
» @ Thread 3 } 
> () Thread 4 


If you ever want to stop 
debugging line-by-line and 
just let your program run 

normally, then tap on this guy! 


Notice our debug cursor has 
moved into the foo() function. 
Now we trace through its 
code too (by hitting "Step 
Over" or "Step Into")... 


This is the "Continue" button. 


[] wpb ^ L 2) & J BMics32lecture2 demo ) (]) Thread 1 ) PY 0 foo() 


Debugging with Xcode 


Quick note on 


breakpoints: ELD int main(int argc, const char * argv[]) 
{ 

We already used Fool); 

breakpoints in our 16 for (int i-0; i«1000000; i++) 


debugging examples, i 


but there's 1 case 
where you really want 
to use them. 


cout << "I'm wasting my time debugging a for loop" << endl; 
} 


double z = cos(10.0) / atan(20.0); 


'z has a value of: " << z << endl; 
return b 


What if I want to start 
debugging at this line? 


Do I really need to step 
through this for loop?! That 
would take years!!! 


Debugging with Xcode 


os — Em ER 
d A 
N i ` ^ en 
- ES 


Debugging with Xcode 


Just add a 
breakpoint! 


After pressing 
Run, Xcode will 
stop at that 
line... 


1 


int main(int argc, const char * argv[]) 


{ 


foo(); 


for (int i=0; i«1000000; i++) 


1 


cout «« "I'm wasting my time debugging a for loop" «« endl; 


} 


double z = cos(10.0) / atan(20.0); 


cout << "z has a value of: " << z << endl; 
return 0; 


foo(); 


for (int i-0; i«1000000; i++) 
1 


} 


After printing out a million of 
these lines © 


int main(int argc, const char x argv[]) 


cout «« "I'm wasting my time debugging a for loop" «« endl; 


double z = cos(10.0) / atan(20.0); 


cout «« "z has a value of: " 
return 0; 


«« z «« endl; 


— Thread 1: breakpoint 1.1 


Debugging 


Learn how to use the debugger! 


It can drastically speed up the 
programming process! 


and more time 
doing the things 
you love! 


Which means less 
frustration 


Topic #1: Include Etiquette 


A. Never include a CPP file in another .CPP or .H file. 


filel.c 


You'll get linker 
errors. 


Only include .H files 
within a .CPP file. 


Topic #1: Include Etiquette 


B. Never put a “using namespace" command in a header file. 


So this is bad... 


someHeader.h 


This is called 
“Namespace Pollution" 


Why? The .H file is 
forcing CPP files that 
include it to use its 
namespace. 


And that's just selfish. 


hello.cpp 


ae Instead, just move the "using" 
E Hello world!” ; commands into your C++ files. 


alcohol.h 
class Alcohol 


{ 


a 
student.h 


#include "alcohol.h" 


class Student 


{ 


private: 
Alcohol bottles [5]; 
js 


#include "student.h" 


int main() 
( 
Student larry; 


Alcohol vodka; 


cout «« larry «« " 


Topic #1: Include 
Etiquette 


C. Never assume that a header file will 
include some other header file for you. 


In this example, main.cpp defines an Alcohol variable 
(vodka) but it doesn't Zzinclude"alcohol.h". That's a bad 
thing, even though in this example the code will compile. 
Why will it work in this case? Because main.cpp includes 
student.h, and right now, student.h includes alcohol.h. 
So main.cpp transitively gets alcohol.h included for it. 
But, a cpp file must NEVER rely upon another header file 
to include a header file for it. That causes problems. 
For example, what if the coder who wrote student.h 
decides to change it and remove the alcohol? 

Let's go to the next slide and see. 


drinking " «« vodka; 


alcohol.h 
class Alcohol 


{ 


ae 
student.h 
#include “redbull .h’” 


class Student 


{ 


private: 
RedBull bottles [5]; 
ae 


#include "student.h" 


int main () 

{ 
Student larry; 
Alcohol vodka; 


Topic #1: Include Etiquette 


C. Never assume that a header file will 
include some other header file for you. 


Utoh! Someone changed our student.h file. Now 
main.cpp no longer compiles! © 
Why? Because it doesn't include alcohol.h but it 
defines an Alcohol variable! 
main.cpp made the assumption that it would just get 
the alcohol header file included for it. But that's a 
bad assumption, because if someone else changes the 
student.h file (changing from alcohol to redbull), 
everything breaks. 
So the moral of the story is that if a cpp file needs 
to define a variable of type X (e.g., X=Alcohol), then 
it must include the x.h header itself, and not expect 
some other header to include the header implicitly. 
o-how-do-we-fix-our-code2-Ne lide! 


cout «« larry «« " is drinking " «« vodka; 


) 


alcohol.h . 
APES ees Topic #1: Include Etiquette 


{ C. Never assume that a header file will 
include some other header file for you. 


a 
student.h 


* To fix the code, simply #include the proper header 
file directly in main.cpp where you're using alcohol 

: S " * That way, your main.cpp guarantees that no matter 

#include "redbull.h how much student.h changes, it won't impact its 

class Student ability to define an alcohol variable. 

{ e Now your main.cpp file will compile correctly 
regardless of what's contained in the other header 

files it uses! 


private: 
RedBull bottles [5]; 
ae 


#include "student.h" 
#include “alcohol .h” 
int main () 


{ 
Student larry; 


Alcohol vodka; 


cout << larry << “ is drinking “ << vodka; 
} 


Topic #2: Preprocessor Directives 


C++ has several special commands which you sometimes need in your programs. 


Command 1: #define 


e You can use the #define command to define new constants (like PI). 

e This technique was used in the original C language to define constants like PI for use in your program. 

* The C preprocessor would do a search-and-replace for the constant string "PI" in your program and 
replace it with the associated value "3.14159", then compile the program normally. 

e But #define is NOT used any more for this purpose in modern C++. Why? Because in C++ we want 
every variable/constant to have an explicit type (like int, double, etc.), but with #define you don't 
specify the data type when you define your constant. 

* So now #define is only used to aid in proper compilation of programs. We'll see how in a bit. 

* Oh, one more thing - you can also use #define to define a new constant without specifying a value (like 
FOOBAR). 

e Why you ask? We'll see! 


Preprocessor Directives 
Command 2: #ifdef and #endif 


e  Youcan use the #ifdef command to check 
if a constant has been defined already... 

* The compiler only compiles the code 
between the #ifdef and the #endif if the 
constant was defined above the #ifdef 

e So if the constant wasn't defined, the 
#ifdef essentially turns into a /* and the 
#Hendif turns into a */, commenting out the 
whole section of code 


file.cpp 
#define FOOBAR 


#ifdef FOOBAR 
void someFunc () 


{ 


cout << PI; 


} 
#endif 


file.cpp 


#ifdef FOOBAR 
void someFunc () 


{ 


cout << PI; 


} 
#endif 


Preprocessor Directives 
Command 2: #ifndef and #endif 


Just as we have #ifdef, we also have #ifndef (if 
NOT defined) 

You can use the #ifndef command to check if a 
constant has NOT been defined already... 

The compiler only compiles the code between the 
#ifndef and the #endif if the constant was NOT 
defined above. 

So if the constant was defined, the #ifndef 
essentially turns into a /* and the #endif turns into 
a */, commenting out the whole section of code 


file.cpp 
#define FOOBAR 


#ifndef FOOBAR 
void someFunc () 
{ 

cout << PI; 


} 


file.cpp Hendif 


#ifndef FOOBAR 
void someFunc () 


{ 
cout << PI; 


} 
#endif 


Separate Compilation 


student.h 
calc.h ee eee oe | 


class Calculator 


{ 
public: 


int compute () ; 


}; 
calc.cpp 


#include "calc.h" 


int Calculator: : compute () 


{ 


#include “student.h” 
#include “calc.h” 


* When using class composition, it helps to define each class in a separate 
pair of .cpp/.h files. For instance, we put our Calculator class in calc.h 
and our Student class in student.h. 

* Then you can #include them individually and use them in your program... 

* Now - something interesting (and bad) happens if we #include a file A 
(calc.h) and file B (student.h) in the same file (main.cpp), and file B 
(student.h) also #includes file A (calc.h) due to class composition. 

e Notice that main.cpp #includes both student.h and calc.h. 

* Further notice that student.h ALSO includes calc.h. 

*  Hmmnl!!! 


int main() 
i 
Student grace; 
Calculator hp; 


grace.study() ; 
hp .compute () ; 


Separate Compilation Problems 


* So what's the problem? Well, since main.cpp includes both student.h and calc.h (#1 and #2), and student.h ALSO 
includes calc.h (#3), during compilation we end up with two definitions of Calculator in main.cpp. 

e . Why? During compilation, the compiler will "pre-process" main.cpp and generate a temporary main.cpp file like the one 
to the right (for final compilation). First the preprocessor processes #include #1 and this copies the contents of 
student.h into the temp main.cpp. While doing this, the preprocessor sees #include #3 and copies calc.h's contents to 
the top of the temp main.cpp file. See #5 and #6 for the Calculator definition and Student definition due to the first 
Ttinclude of student.h by #1. 

* After including student.h, main.cpp then directly #includes calc.h (#2). This causes the 


contents of calc.h to be copied again to the temp main.cpp file (#7). main.cpp (temp version) 
*  Theresult is two definitions of the Calculator class in the same main.cpp Sees IEEE 
file (#5 and #7), which is not allowed in C++. This results in a compiler error. { 


calc.h public: 


void compute () ; 


class Calculator SES 


{ 
pee: class Student 
HOLME: E #include "student.h" { 
int compute () ; #include "calc.h" SSS: 


void study () 


"i 
student.h 


#include “calc.h” 


int main () 


{ 


private: 
Calculator myCalc; 
pe 
class Calculator 
{ 
public: 
"void compute () ; 


Student grace; 
Calculator hp; 


grace.study () ; 
hp.compute () ; 


class Student 
{ 

public: 

void study () ; 


):; 
int main() 


1 


) 


E e Student grace; 
> t Calculator hp; 
private: Seo 
Calculator myCalc; grace.study(); 
hp . compute () ; 


J; : 


Fixing Separate Compilation Problems 


e  Tofix this problem you must add “include guards" to the top and bottom of ALL header files. 
*  Aninclude guard is a special check that prevents duplicate header inclusions in the same file (like main.cpp). 
* . If your header file is called xyz.h, then add the following lines to the VERY top of the header file: 
Zifndef XYZ H 
Zidefine XYZ H 
* . And add the following line to the VERY end of the header file: 
Zendif // XYZ H 
* See the examples below on the left for calc.h and student.h. 
* Now after you #include your headers in main.cpp, this is what it will look like when the compiler generates a temp 
version of main.cpp that includes the header file contents (See main.cpp initial temp version) 
* Due to the include guards, when this temp version of main.cpp is compiled, the compiler will get to line #1 and see that 
CALC H is not defined, so it will #define CALC H on line #2 and then include the first definition of Calculator. 
* When the compiler reaches the second #ifndef CALC H on line #3, the CALC H constant will have been defined (on 
line #2), and so C++ will skip over the second definition of calculator, ignoring the code through line #4. The final code 
will look like the one on the right. So there's only one definition of the Calculator class in main.cpp and C++ is happy. 


calc.h 
#ifndef CALC_H 


#define CALC_H 


class Calculator 
{ 
public: 

void compute () ; 


}; 
#Hendif // for CALC_H 


student.h 


main.cpp (initial temp version) 


#ifndef STUDENT. H 
efine STUDENT. H 


#ifndef CALC H x #1 


#define CALC | He 
class Calculator #2 
{ 
public: 
void compute(); 
Hendif // for CALC_H 
class Student 
{ 


L 
Calculator myCalc; 
sfendif // for STUDENT. H 


#ifndef cac H € #3 


#define CALC_H 
class Calculator 
{ 


public 
void compute(); 


a ndif // for cauc H & H4 


int main() 


Student grace; 
Calculator hp; 


grace. study(): 
NL compute(); 


main.cpp (final temp version) 


s Hos STUDENT. | H 
ie STUDENT. | 


#ifndef CALC H 
#define CALC H 
class Calculator 
public: 

void compute(); 
X 
#endif // for CALC H 
class Student 


public: 

void study() 

i 1 

Calculator myCalc; 
#endif // for STUDENT. H 


int main() 
{ 


Student grace; 
Calculator hp; 


grace. study(); 
hp.compute(); 


alcohol.h T" 
ee se Last Topic: Knowing 


í WHEN to Include .H Files 


public: 
void drink () { cout << “glug!”; } 


You might think that any 
time you refer to a class, 
you should include its .h 
file first... Right? 


dit 


student.h 


#include "alcohol.h" 


class Student 
{ 

public: 

void beIrresponsible(); 


Well, not so fast! 


private: 
Alcohol *myBottle; 
); 


class FirstClass Last Topic: Knowing 
í WHEN to Include .H Files 


public: 


void someFunc() {... } * Here are the rules: You must include the header file 
); (containing the full definition of a class) any time: 
1. You define a regular variable of that class's type, OR 
2. You use the variable in any way (call a method on it, 
return it, etc). 
e Why? Because C++ needs to know the class's details in 
order to define actual variables with it or to let you 
p s call Mir from it! ” 
{ e On the other hand... 
public: 


void otherFunc () 


{ 
FirstClass y; 


FirstClass b[10]; 


#include “A.h” 


y.someFunc () ; 
return (y) ; 


private: 
FirstClass x; 


FirstClass a[10]; 
ae 


class FirstClass 
{ 
public: 
void someFunc() {... } 
p 


class FirstClass; // #1 


class SecondClass 
{ 
public: 


void goober(FirstClass pl); 
FirstClass hoober(int a); 

void joober(FirstClass &pl); 
void koober (FirstClass *p1); 


void loober() 


{ 
FirstClass *ptr; 


} 


private: 
FirstClass *ptrl, *z[10]; 


ie 


Last Topic: Knowing 
WHEN to Include .H Files 


If you do NONE of the previous items, but you... 
1. Use the class to define a parameter to a 
function, OR 
2. Use the class as the return type for a func, OR 
3. Use the class to define a pointer or reference 
variable 

Then you DON'T need to include the class's .H file. 
(You may often do so, but you don't need to) 
Instead, all you need to do is give C** a hint that 
your class exists (and is defined elsewhere). 

Look at line #1 to see how you do that. 
In your .h header file, you simply write the word 
"class" followed by the class name you want C++ to 
know about INSTEAD of using the #include. 

This line tells C++ that your class exists, but 
doesn't actually define all the gory details. 
Since none of the code in file B.h actually uses 
the "guts" of the class (as the code did on the 
previous slide), this is all C++ needs to know to 
define the header file! 
Then, in your .cpp file, you do #include the 
required header file at the top of the file (the one 
that defines FirstClass) normally. 

This allows your .cpp file to have the full definition 
of the class so it can call its functions and access its 
data members ,. 


class FirstClass 
{ 
. // thousands of lines 
. // thousands of lines 
}; 


#include “A.h” // really slow! 


class SecondClass 
{ 
public: 


Last Topic: Knowing 
WHEN to Include .H Files 


Wow - so confusing! 


Why not just always use #include 
to avoid the confusion? 


There are two reasons: 


1. If a .h file is large (thousands 

of lines), #including it when you 
don't strictly need to slows down 
your compilation. Especially if 
you're compiling thousands of files 
that include your really long .H file. 


2. If two classes refer to each 
other, and both classes try to 
#include the other's .H file, 

youll get a compile error. Let's see 
that case.s 


Students and Classrooms 


Every student knows what class he/she is in... 


Every class has a roster of its students... 


These type of cyclical relationships cause #include problems! 


Last Topic: Self-referential Classes 


Our ClassRoom class refers to the Student class so it includes Student.h 
And our Student class refers to the Classroom class, so it includes Classroom.h 


Do you see the problem? 


Student.h tries to include Classroom.h which tries to include Student.h which tries to include Classroom.h and on and on. 
This will cause the compiler to die! The include guards we learned won't solve the problem (try for yourself to see why) 


Student.h 


#include "ClassRoom.h" 


class Student 


{ 
public: 


private: 


ClassRoom *m myRoom; 


Student.cpp 


#include “Student.h” 


void Student: :printMyClassRoom() 
{ 


cout <<“I’m in Boelter #” << 
m myRoom-»getRmNum(); 


ClassRoom.h 


class ClassRoom 


{ 
public: 


private: 


Student m_studs[100]; 


ClassRoom.cpp 


#include "ClassRoom.h" 


void ClassRoom: :printRoster () 


{ 
for (int i=0;i<100;1i++) 
cout << m studs[i].getName(); 


} 


So how do we solve this cyclical nightmare? 


Step #1: 
Look at the two class definitions in your .h files. At least one of 
them should NOT need the full #include. 


Question: 
Which of our two classes doesn't need the full #include? Why? 


Student.h 


#include "ClassRoom.h" 


This class JUST defines a pointer 


class Student to a ClassRoom. It does NOT hold a 


{ full ClassRoom variable and 
public: 


therefore doesn't require the full 
class definition here!!! 


private: 
ClassRoom *m myRoom; 


); 


ClassRoom.h 


#include "Student.h" 


class ClassRoom 


{ 
public: 


This class defines actual full 
Student variables... It 
therefore requires the full 
class definition to work! 


private: 
Student m_studs[100]; 
jo 


So how do we solve this cyclical nightmare? 
Step #2: 
Take the class that does NOT require the full #include 
(forget the other one) and update its header file: 


Replace the #include "XXXX.h" statement 
with the following: class YYY; 
Where YYY is the other class name (e.g., ClassRoom). 


This line tells the compiler: 

"Hey Compiler, there's another class called 

ClassRoom' but we're not going to tell you 
exactly what it looks like just yet." 


Student.h ClassRoom.h 
class ClassRoom: #include "Student.h" 


class ClassRoom 


{ 
public: 


class Student 


{ 
public: 


private: 
Student m_studs[100]; 


private: 
ClassRoom *m_myRoom; 


by bi 


So how do we solve this cyclical nightmare? 


Student.h 


class ClassRoom: 


class Student 


{ 
public: 


private: 
ClassRoom *m myRoom; 


pr 


Student.cpp 

#include “Student.h” 

"include "ClassRoom.h" 

void Student::printMyClassRoof() 
{ 


cout ««"I'm in Boelter #’/<< 


m myRoom-»getRmNum(); 


Step #3: 

Almost done. Now update the 
CPP file for this class by 
Ztincluding the other header 
file normally. 


This line tells the compiler: 


"Hey Compiler, since my CPP file 
is going to actually 
use ClassRoom's functionality, 
Ill now tell you all the details 
about the class." 


The compiler is happy as 
long as you #include the 
class definition before you 
actually use the class in 
your functions... 


So how do we solve this cyclical nightmare? 
Step #4: 
Finally, make sure that your class doesn't have any other 
member functions that violate our #include vs class rules... 


* If you have defined the full (body) of one or more functions DIRECTLY in your class definition in your .h file AND 
they use your other class in a significant way, then you must MOVE them to the CPP file. 

e Consider the definition of the beObnoxious() function in Student.h (#1). The function uses the Classroom variable 
m myRoom by calling the getRmNum() method. That won't work anymore since Student.h doesn't have a full 
definition of the Classroom class anymore. 

e So instead, just define the function prototype (#2) in your .h file, and move the full definition of your function to 
your .cpp file (#3), after you've included the proper header file. 


Student.h Student.h 


class ClassRoom:; 


class ClassRoom: 


class Student 


{ 
public: 


class Student 


{ 
public: 
void beObnoxious() /* #1 */ { void beObnoxious(); // #2: just define prototype 
cout << m_myRoom->getRmNum() << “ sucks!”; } 
private: 
ClassRoom *m_myRoom; 


Pe 


private: 
ClassRoom *m_myRoom; 


I 


Student.cpp Student.cpp 
#include "Student.h" 
#include "ClassRoom.h" // now we have the full classroom def! 


// write the full function ( body) here! 
void Student::beObnoxious() ( // #3 
cout << m myRoom-»getRmNum() << `“ sucks!”; } 


#include “Student.h” 
#include “ClassRoom.h" 


. // code 


So how do we solve this cyclical nightmare? 


Now let's look at both of our classes... Notice, we no longer 
have a cyclical reference! Woohoo! 


Student.h ClassRoom.h 


#include "Student.h" 


class ClassRoom; 


class ClassRoom 


{ 
public: 


class Student 


{ 
public: 


private: 
Student m_studs[100]; 


private: 
ClassRoom *m myRoom; 


); ):; 


Student.cpp ClassRoom.cpp 


#include “Student.h” #include “ClassRoom.h” 


#finclude “ClassRoom.h" 


void Student: :printMyClassRoom () void ClassRoom: :printRoster () 


{ { 
cout ««"I'm in Boelter #” << 
m myRoom-»getRmNum(); 


for (int i=0;1<100;i++) 
cout << m studs[i].getName(); 
} 


Default Arguments! 


void poop(string name, int numberOfWipes) So what do you 


{ notice about the 
cout << name << “ just pooped.\n”; following code? 


cout << “They wiped “ << numberOfWipes << 
" times.\n”; 


(other than David 
really needs to wipe) 


Right! Most of the 
time, people wipe 
exactly twice! 


int main () 


{ 


poop (“Phyllis” ,2) ; 
poop (“Astro” ,2) ; 

poop ("Sylvia",2); Wouldn't it be nice 
poop ("Carey” , 3) ; if we could simplify 


poop (“David” ,0) ; 
poop (“Sergey” ,2) ; 
poop (“Larry” , 2) ; 
poop (“Devan” ,2) ; 


our program by 
taking this into 
account? 


Default Arguments! 


void poop(string name, int numberOfWipes = 2) We can! 


{ Let's see how! 
cout << name << “ just pooped. \n”; 
cout << “They wiped “ << numberOfWipes << 


" times. \n”; 


C++ lets you specify 
a default value for 
a parameter... 


like this... 

int main() Now, when you call 

{ the function, you can 
poop("Phyllis" ); leave out the 
poop("Astro" ); parameter if you just 
poop ("Sylvia",7); Note: We still need to want the default... 
poop ("Carey",3); pass in the value any time 
poop ( “David” ,0) ; we don't want the default! and C++ will 


poop(“Sergey” ); ZTUU D DO 0 
poop("Larry" ); // defaults to passing in 2 
poop("Devan" );  // defaults to passing in 2 


automagically pass 
in that default 
value! 


Default Arguments! 


void fart(int length = 10, int volume = 50) 
{ 


You can have more 


. than one default 
cout << “I just SERIES for << length parameter if you like, 
<< “ seconds, and it was" 


ee will £i 
<< volume << “ decibels loud.\n” and C++ will figure 
} out what to do! 


int main() But you can't do 

{ something like this! 
fart(20,5); // long but no 
fart(5); violent burst! Why not? Good 
fart(); edium and pretty loud question - ask the 
fart(,30); // NOT ALLOWED C++ language 


designers. & 


Default Arguments: One other thing 


If the jt parameter has a default value, then all of the following 
parameters (j*1 to n) must also have default values. 


// INVALID! Our 15t param is default, but 2?4 and 3*¢ aren't! 
int pitch) 
// INVALID! Our first 2 params are default, but 3'?4 isn't! 
bool burp(int length = 5, int loudness = 12, int pitch) 
// INVALID! Our 15t param is default, but 2"4 isn't! 


bool burp(int length = 5, int loudness, int pitch = 60) 
{ 


} 


// PERFECT! All parameters are default 
bool burp(int length = 5, int loudness = 5, int pitch = 60) 


// PERFECT! All default parameters come after non-defaults 
bool burp(int length, int loudness = 5, int pitch = 60) 
{ 


} 


Class Challenge 


RULES 


T 1 T 2 
The class will split into left and eam 77 eam # 
right teams l 
One student from each team will | FUNC() 
come up to the board ame | 


Each student can either 
- write one new line of code to solve 
the problem OR 
- fix a single error in the code their 
teammates have already written 
Then the next two people come up, 
etc. 
The team that completes their 
program first wins! 


Challenge #1 


Write a class called Quadratic which represents a 
second-order quadratic equation, e.g.: 4x*+3x+5 


When you construct a Quadratic object, you pass in the 
three coefficients (e.g., 4, 3, and 5) for the equation. 


The class also has an evaluate method which allows you 
pass ina value for x. The function will return the value 


of f(x). 


The class has a destructor which prints out "goodbye". 


Challenge #2 


Write a class called MathNerd which represents a 
math nerd. Every MathNerd has his own special 
quadratic equation! 


When you construct a MathNerd, he always wants you 
to specify the first two coefficients (for the x^ and x) 
for his equation. 


The MathNerd has a getMyValue function which accepts 
a value for x and should return f(x) for the nerd's QE. 


